home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d957.lha / PARex / PARexScripts.doc (.png) < prev    next >
ANSI Art File  |  1993-11-24  |  20KB  |  640x7168
Labels: darkness | space | star | black | constellation | universe | astronomy
OCR: << <<< PARex v3.00 PAREX-SCRIPTS MANUAL - Release: 22-Nov-93 Copyright 1991-1993 Chris P. Vandierendonck, [AniSYS]. All scripts in the "PARexScripts" have the "s"-bit set SO starting from AmigaOS v1.3 you can just type the name of script to execute it. (Users of earlier versions need to use the "Execute command to execute the script.) Note that this directory is used by sone scripts through the "PAREX: assign, so don't forget to set this assign at system startup! Most of the scripts in the "PAREX:" directory have the following two arguments: the name of the source file is always required. - FROMFILE/A -PAREXARGS/F here you can specify any PARex option, without having to put then all between double quotation narks. I StripC ran:source SILENT STAT, where the last two arguments fall under the I PAREXARGS argument That's the Sone may have noticed that no destination file is required because PARex will create a destination file under the name of source file with the ".prx specifiy a destination file, PAREXARGS argument. suffix. If however, you want to then you must do this under the 'S Stripc ran:source TO ran:Source_strip STAT will I all C-comments from the ran:source file, and save the file as Iran:Source_strip, after which detailed information will be I given on the processing. AutoVERS Purpose: auto source version updating. Usage: SOURCE/A, REUNAME/A, INIT/S,M2/S,C/S,OBERON/S,ASM/S, AREXX/S, AMIGADOS/S, PAREXARGS/F Script: "AutoVERS.px" Connent: This program script does two things, first it can create a new source file including a header, secondly it can update this source file. To create a new source file, the following arguments must be given SOURCE/A -REUNAME/A: path and nane of the new source file nane by which you want to t to update this source file. This name is important since it'll be used to store the PARex 3.0x PARexScripts Manual - Page 1 version number into an environment variable called "REUNAME.pau". The variable is also copied to "ENVARC:" to make sure that the actual version isn't forgotten the next time we boot up the Aniga! - INIT/S suitch will make AutoVERS to create a new source file. If this keyword isn't given then the source file would be updated! - M21C1OBERON LASMIAREXX IAMIGADOS: one of these keywords must be used to indicate what sort of source file to create, else AutoVERS assunes it's AnigaDOS script. In order to create a neu source file, AutoVERS needs to have tuo template files: one for the header to install called "Header XX", and one for the source itself (e.g. enpty progran) called "BlankSource_XX", where "XX" represents M2, C, OBERON, ASM, AREXX or AMIGADOS. Remember to follow this rule when creating files for a new language! The supplied template files are just simple examples and can be freely adapted to fit your own needs! All these template files nust "PAREX: AutoVERSFiles" be stored in I AutoVERS RAM:source Junny M2 INIT I This will create a Modula-II source file I'RAM:source'. The environment variable "Junny" is I used to store the source's current version. To update a source file, you must use the following arguments: - SOURCE/A path and nane of the source file to update. REUNAMEA: nane as defined when creating the source file, and refers to "ENU: <REUNAME>.pau" which holds the current version number. After calling AutoVERS, this variable is incremented by 1. The new value is "ENVARC: <REUNAME>.pau" current version isn't forgotten next time we boot up the Aniga! copied to the I AutoVERS RAM:source Junny This will update the Junny variable and use its I neu value in the RAM:source file. You can then I start to compile the source with the new values. IMPORTANT: Since the updating of the source file is done must make sure that the size of the header stays the same! So it's important to use MINSIZE and MAXSIZE for the items in the header that will be updated. PARex v3.0x - PARexScripts Manual - Page 2 TIP: suppose you also want to update the version and other data in the source file itself, then it's best st you edit the AutoVERS program and replace the TOUCH option with CONVERT. TOUCH was only used to make updating of large source files very quickly. If your source file is a very large file, then it's more rational to put the progran information you want to update in a seperate source file. This will only take a feu hundred bytes, and give a much faster update when using CONVERT! ConvertSYS Purpose: convert files between Aniga,MS-DOS,05/2 & Unix. Usage: FROMFILE/A, MODE/K/A, PAREXARGS/F Script: "ConvertSYS.pxs" Connent: This program will convert files from one computer system to another. Generally some characters from one ASCII code set are replaced by their equivalent value in the other ASCII code set. Use the MODE argument to specify one of the following supported modes AMIGAtoPC, AMIGATOOSZ, PCLOAMIGA, PCto0SZ, OSZŁOAMIGA, OSZtoPC. (UNIX nodes are to be added later, or 'DIY'!) I ConvertSYS ran:text MODE AMIGALOPC This will I convert the ran:text file to its PC format. Find Bold Purpose: puts a searchstring in bold text. Usage: FROMFILE, FIND/K/A, PAREXARGS/F Connent: This program will search a file for a given name (string) and put put it in bold text in the following way: "Ne[1nFOUNDNAMENe[On". The original case of the nane is preserved. Use a text-viewer to see the result. I FindBold ran:source FIND pa?x WILD will show I all strings in the ran:source file which match the I pattern, by putting then in bold text. FindLight Purpose: puts a searchstring in reverse white text. Usage: FROMFILE/A, FIND/K/A, PAREXARGS/F Connent: This program will (string) and put it way: e131:42 verse search a file for a given name e text in the following E>Ne[On". The original case of the name is preserved. Use a text-viewer to see the result PARex v3.0x - PARexScripts Manual - Page 3 HEXDump Purpose: hexadecimal output of a file. Usage: FROMFILE/A, PAREXARGS/F Connent: Using HEXDunp ran:source TO SILENT will print the ran:source file in hexformat in the Shell window. If you want to specify a hexdump format, then the formatstr must be the first argument after the source name. E.g. HexDump ran:source "P8: %B8%d164" TO SILENT NeuCopy Purpose: copy files. Usage: FROMFILE/A, DESTFILE/A, PAREXARGS/F Connent: This program is an enhancement to the "Copy" command, since this script not only copies files, but also gives the opportunity to specify some replace commands to use during the copying. New Type Purpose: shous text files. Usage: FROMFILE/A, PAREXARGS/F Connent: This program is an enhancement to the since this script not only copies "Type" command, files, but also gives the opportunity to specify some replace commands to use during the showing. To To output to another file, instead of the Shell window, use the TO option. Print Purpose: sends a text file to printer. Usage: FROMFILE/A, PAREXARGS/F At the end of the file a page eject character is send. Connent: Renove the CLOSE connand if you do not want this or call this script as: Print <file> CLOSE **** *. DocPrint Purpose: prints a text file in elite characters, with its name as a header Usage: FROMFILE/A, PAREXARGS/F Connent: Before the actual text of the file, its name is printed in bold (elite) text. At the end a page eject character is send. SrePrint Purpose: prints a source file in condensed text, with its name as a header Usage: FROMFILE/A, PAREXARGS/F Connent: Before the actual text of the file, its name is PARex v3.0x-PARexScripts Manual - Page 4 printed in bold (elite) text. At the end a page eject character is send StripAREXX Purpose: strips AREXX conments. Usage: FROMFILE/A, PAREXARGS/F Connent: The first comment is left intact, since ARexx demands this! StripDOS Purpose: strips AnigaDOS script connents. Usage: FROMPILE/A, PAREXARGS/F Connent: StripASM Purpose: strips assemble source comments. Usage: FROMFILE/A, PAREXARGS/F Connent: StripC Purpose: strips C source comments. Usage: FROMFILE/A, A,PAREXARGS/F Connent: Catches nested comments also. StripM2 Purpose: strips Modula-II source comments. Usage: FROMFILE/A, PAREXARGS/F Connent: Catches nested connents also. StripOBERON Purpose: strips Oberon source comments. Usage: FROMPILE/A, PAREXARGS/F Connent: Catches nested comments also. AddCR Purpose: convert LF to CR+CR. Connent: Usage: FROMFILE/A, PAREXARGS/F The Aniga uses LF for an end-of-line code, whereas MS- DOS uses CR+LF. This program will convert all LF codes to CR+LF If a CR-LF should already exist, then they will be left alone, thus no CR CR-LF will occur! PARex v3.0x-PARexScripts Manual - Page 5 Cutlines Purpose: Usage: FROMFILE/A, cut LF LF LF... to LF LF. PAREXARGS/F Connent: This program will convert a row of LF's with more than StripCR two, to LF LF Purpose: converts CR-LF to LF. Usage: FROMFILE/A, PAREXARGS/F Connent: MS-DOS StripHR uses CR-LF for an end-of-line code. The Aniga program will convert all CR-LF uses LF This only codes to LF. Purpose: strips hard-returns from a text Usage: FROMFILE/A, PAREXARGS/F Connent: Useful uhen loading a text file in program first. It'll strip all they are followed by a space, a tab a wordprocessor, to run this hard returns, unless or another hard return. StripMEMPAGE Purpose: strips neupage characters from Usage: FROMFILE/A, PAREXARGS/F Connent: Strips all neupage codes ($0C) a file. from the source file. StripGUIDE Purpose: converts AnigaGuide files to normal text files. Usage: FROMFILE/A.PAREXARGS/F Script: "StripGUIDE.pxs" program will erase all commands used in Comment: This AnigaGuide documents, which results in a plain text. file. Useful for those Aniga users who don't have the and to renove all the AnigaGuides program commands for a more readable text. Purpose: renaps black and white print control sequences. Usage: FROMFILE/A, PAREXARGS/F Script: "RenapCTRL.px" This program Connent: and black control sequences as will convert the white used in programs or knows, since AnigaDOS u2.x the white and black colours have switched places. In other words if a program uses "Ne[31n" under v1.x prints in white, but under AnigaDOS u2.x later is in black. For sone users this could be annoying. This progran now v3.0x-PARexScripts Manual - Page 6 PARex let's you use the proper colours. StripCTRL Purpose: renoves AmigaDOS print control sequences. Usage: FROMFILE/A, PAREXARGS/F Script: "StripCTRL.px" Connent: This program will erase all AmigaDOS print control sequences. ShouPARex shous PARex name and version in 3D text. File: "PARexHeader" Purpose: Usage: Connent: The output looks best under OS v2.x and later. Purpose: Connent: nakes a program script. Usage: SCRIPTNAME/A, PAREXARGS/F File: "Empty.pps" Creates a progran script called "PAREX: <SCRIPTNAME>", nakes a parex script. Usage: SCRIPTNAME/A, PAREXARGS/F File: "Empty.pxs" Creates a data script called "PAREX: <SCRIPTNAME>.pxs". Purpose: Connent: PARex v3.0x-PARexScripts Manual - Page 7 RenapCTRL MakePPS MakePXS AnigaDOS and want as printed